三元组 x64-android、arm-neon-android 和 arm64-android 通过 vcpkg 精心策划的注册表持续集成进行了测试。

下载 Android NDK

将环境变量“ANDROID_NDK_HOME ”设置为 Android NDK 安装以设置 Android 工具链。 例如：

或：

注意：仍然需要安装以主机作为目标的 g++ 或 C++ 编译器才能获得主机依赖项。

有 6 个不同的 Android ABI，每个映射到一个 vcpkg 三联密码。 下表概述了从 vcpkg 体系结构到 android 体系结构的映射：

可以构建 Android 库，例如 Ubuntu Docker 容器中的 jsoncpp。

使用以下内容创建 Dockerfile：

构建图像并发布新的容器。

在容器中，使用以下内容创建 /project/vcpkg.json：

最后，运行 vcpkg install --triplet x64-android 以构建面向 android jsoncpp。

vcpkg 有一个 vulkan 包允许你 find_package(Vulkan)。 必须提供“VULKAN_SDK”环境变量才能使用它。

NDK 已包含其每个体系结构的 Vulkan 标头和 libvulkan.so 库。

可以考虑为每个安装使用 export VULKAN_SDK=... 来将它们暴露给 vcpkg。 不过将 set(ENV{VULKAN_SDK} ...) 放入三联密码文件中可跳过重复的工作。

如果使用的是 NDK 21.3.6528147 或更低版本，则如下所示：

请注意，自 NDK 22 起，sysroot 的位置已经改变。 （有关详细信息，请参阅[BUG] 自 r22? 起缺少 sysroot 标头）。

如果想要使用最新版本，请查看 NDK 文档的 BuildSystemMaintainers.md，然后放入系统合适的路径。

例如，Mac OS 用户将使用如下例所示路径：

请为所有 android 三联密码执行此操作，可以安装 vulkan 和要求它的包。 （例如 vulkan-hpp）

文件夹 docs/examples/vcpkg_android_example_cmake 提供了一个工作示例，其中包含使用 jsoncpp 库的 android 库：

CMakeLists.txt 只是使用 find_package 和 target_link_library

可以使用 compile.sh 脚本来选择“android abi”/“vcpkg triplet”的任何匹配对，并测试编译。

虚拟 my_lib.cpp 文件使用 jsoncpp 库

注意

此示例仅编译 Android 库，因为编译完全成熟的 Android 应用不在本文档的介绍范围内。

使用 vcpkg_android.cmake 进行测试。

文件夹“vcpkg_android_example_cmake_script”提供相同的示例，并使用 cmake 脚本来简化用法。

如果设置了标志“VCPKG_TARGET_ANDROID”，则主 CMakeLists.txt 会加载 vcpkg_android.cmake：

重要

在调用 project() 之前放置这些行。

显示compile.sh 脚本，然后可以使用简单的 cmake 调用为 android 进行编译，例如：

注意

本部分介绍 vcpkg 的实验性功能，此类功能随时可能会更改或删除。

vcpkg 可以导出 android 存档（AAR 文件）。 创建存档后，可以作为本机依赖项导入 Android Studio。 存档使用 android Studio 的 prefab 工具自动使用的。

有关 Prefab 的详细信息，请参阅：

注意

Android Studio 用户：Android Studio 4+ 支持的 prefab 包。

将环境变量“ANDROID_NDK_HOME”设置为 android ndk 安装。 例如：

7zip 或 zip

maven

Android 三联密码

注意

需要全部四种体系结构才能使用“prefab”（请见下文）。 如果缺少任何一种体系结构，则导出将会失败。

首先，“vcpkg 安装”4 个 android 体系结构（必须导出其中所有 4 个体系结构）：

然后，导出 prefab：

注意：

应会看到如下所示的输出：

请参阅此处的示例 GitHub 存储库：

atkawa7/prefab-vpkg-integration-sample